home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / admin / dig-2.0 / dig-2 / dig.2.0 / README-2.0 < prev    next >
Encoding:
Text File  |  1990-09-10  |  6.8 KB  |  160 lines
  1.  
  2. /*
  3. ** Distributed with 'dig' version 2.0 from University of Southern
  4. ** California Information Sciences Institute (USC-ISI). 9/1/90
  5. */
  6.  
  7.    Distribution history:
  8.      o  Version 2.0        public distribution     9/1/90
  9.      o  Version 2.0.beta    private distribution    5/9/90
  10.      o  Version 1.1.beta    private distribution  10/26/89
  11.      o  Revised version 1.0 public distribution    4/15/89
  12.           to include file: dig.1
  13.      o  Version 1.0         public distribution    3/29/89
  14.  
  15.  
  16. Greetings.
  17.  
  18. You are the proud owner of 'dig' Version 2.0; a command-line tool
  19. for querying Domain Name System servers.  With proper care and
  20. treatment, you will be able to enjoy your digger for many years
  21. to come.
  22.  
  23. For those familiar with version 1.0, among the additions and
  24. modifications you'll find:
  25.  
  26.    o support for zone transfer queries/responses
  27.    o convenient form for address lookups (i.e. "dig -x 129.1.1.2")
  28.    o coredump on large pkt problem fixed
  29.    o man pages reformatted
  30.    o various bugs fixes
  31.    o several minor changes to output format
  32.  
  33.  
  34. The files in this distribution are:
  35.  
  36. Makefile                netdb.h                 res_mkquery.c
  37. Makefile.resolv@        options.c               res_query.c
  38. README-2.0              param.h                 res_send.c
  39. dig.1                   pflag.h                 resolv.h
  40. dig.c                   qtime.c                 sethostent.c
  41. gethostnamadr.c         qtime.h                 strcasecmp.c
  42. herror.c                res.h                   subr.c
  43. hfiles.h                res_comp.c              subr.h
  44. list.c                  res_debug.c
  45. nameser.h               res_init.c
  46.  
  47.  
  48.  
  49. COMPILING DIG
  50. =============
  51.  
  52. As is, 'dig' currently compiles without modification in several
  53. sun3, sparc, vax, microvax, & RT environments.   When initially
  54. attempting other environments, several #include files were found
  55. to be non-existent and/or misplaced on the various systems.  These
  56. files (arpa/nameser.h, sys/param.h, netdb.h, resolv.h) have been
  57. included with this distribution and are included in 'dig' through the
  58. #define statements in the file "hfiles.h".  If 'dig' or the resolver
  59. library does not compile "as-is" (or if you want to include your more
  60. up to date files) you can simply change the #define's in "hfiles.h".
  61.  
  62.  
  63. If problems arise when porting to other architectures, often the
  64. only problem is that your machine is not among those listed in the
  65. #if defined() statements in the definition of the HEADER structure
  66. in the file "nameser.h".  Including your own nameser.h file (see note
  67. above) or defining your machine as appropriate should take care of
  68. this.
  69.  
  70. Dig may be compiled with you own resolver library (if it was compiled
  71. -DDEBUG), but expect the following changes:
  72.  
  73.     o RTT and packet count stats are not printed
  74.     o different output format (closer to nslookup)
  75.     o print options are meaningless
  76.  
  77. If you are going to compile using your own resolver you must set the
  78. "-DRESLOCAL" flag (the Makefile also understands "make dig.local").
  79.  
  80.  
  81. Dig will also work in environments that are not currently running
  82. the Domain Name System. This may be useful while bringing up the
  83. system. However, this may require slight adjustments or impose
  84. certain constraints ... from the man pages:
  85.  
  86.     (NOTE: If the server to query is specified by its domain
  87.     name, this name will be resolved using the domain name system
  88.     resolver. If your system does not support DNS, you may *have*
  89.     specify a dot-notation address. Alternatively, if there is
  90.     a server at your disposal somewhere, all that is required
  91.     is that /etc/resolv.conf be present and indicate where the
  92.     default name servers reside, so that server_name itself can
  93.     be resolved. See man resolver(5) for /etc/resolv.conf
  94.     information. Also, the user may set the environment variable
  95.     LOCALRES to name a file which is to be used instead of 
  96.     /etc/resolv.conf. If this variable is not set or the file
  97.     is not readable then /etc/resolv.conf will be used.)
  98.  
  99.  
  100. If you prefer, 'dig' has already been compiled for the sun3, vax, and
  101. sparc architectures, and are also available via anonymous ftp from
  102. venera.isi.edu in files:
  103.                pub/dig-obj.sparc.tar.Z
  104.                pub/dig-obj.vax.tar.Z
  105.                pub/dig-obj.sun3.tar.Z
  106.  
  107. In each of the above files you will find the appropriate resolver
  108. library (libresolv.a) and an object version of `dig`.
  109.  
  110. Thanks go to the many folks with comments and suggestions
  111. about earlier versions.  Particular thanks to Andrew Cherenson
  112. (arc@sgi.com) for finding and fixing several details (including
  113. revamping of the man page).
  114.  
  115. Comments and suggestions (gripes & bug reports ;^) are welcome.
  116.  
  117. Steve Hotz (hotz@isi.edu)
  118. Paul Mockapetris (pvm@isi.edu)
  119.  
  120.  
  121. ADDENDUM:
  122.  
  123. MODIFICATION HISTORY
  124. ====================
  125.  
  126.  **    dig - domain internet groper                                **
  127.  **                                                                **
  128.  **           Version 2.0 (9/1/90)                                 **
  129.  **               o renamed difftime() difftv() to avoid           **
  130.  **                 clash with ANSI C                              **
  131.  **               o fixed incorrect # args to strcmp,gettimeofday  **
  132.  **               o incorrect length specified to strncmp          **
  133.  **               o fixed broken -sticky -envsa -envset functions  **
  134.  **               o print options/flags redefined & modified       **
  135.  **               o Error code printed if axfr fails               **
  136.  **               o man page reformatted                           **
  137.  **                                                                **
  138.  **           Version 2.0.beta (5/9/90)                            **
  139.  **               o output format modified - helpful to `doc`      **
  140.  **               o minor cleanup                                  **
  141.  **               o released to beta testers                       **
  142.  **                                                                **
  143.  **           Version 1.1.beta (10/26/89)                          **
  144.  **               o hanging zone transer (when REFUSED) fixed      **
  145.  **               o trailing dot added to domain names in RDATA    **
  146.  **               o ISI internal release                           **
  147.  **                                                                **
  148.  **           Version 1.0.tmp  (8/27/89)                           **
  149.  **               o Error in prnttime() fixed                      **
  150.  **               o no longer dumps core on large pkts             **
  151.  **               o zone transfer (axfr) added                     **
  152.  **               o -x added for inverse queries                   **
  153.  **                               (i.e. "dig -x 128.9.0.32")       **
  154.  **               o give address of default server                 **
  155.  **               o accept broadcast to server @255.255.255.255    **
  156.  **                                                                **
  157.  **           Version 1.0  (3/27/89)                               **
  158.  **               o original release                               **
  159.  
  160.